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(57) Abstract 

A method for generating dynamic output from a source includes providing a web browser request to a web server (202), the web 
browser determines whether a dog file is being requested, and if the dog file is not being requested, the web server provides a response 
to the web browser (201). If the dog file is being requested, the web server provides a web server request to a dog server (203) based on 
the web browser request. The dog server provides a dog file extraction request to a dog kennel (204). The dog kennel returns a copy of 
a compiled dog file to the dog server (203). The dog server (203) executes the compiled dog file and provides the dynamic output to the 
web browser (201). 
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METHOD AND APPARATUS FOR GENERATING A DYNAMIC 
WEB PAGE AND INTERFACING EXTERNAL SYSTEMS 

Reference To Paper Appendix 

The present application includes a paper appendix attached 
hereto setting forth exemplary core dog tags of an exemplary 
embodiment of the present invention which is hereby incorporated 
by reference. A portion of the disclosure of the present 
application includes material which is subject to copyright 
protection. The copyright owner has no objection to the 
facsimile reproduction by anyone of the patent disclosure, as it 
appears in the Patent & Trademark Office patent files or records, 
but otherwise reserves all copyright rights whatsoever. 
Field Of The Invention 

The present invention relates to the generation of dynamic 
output from data driven instructions, such as generating dynamic 
web pages from web pages embedded with predefined tags, and 
interfacing with other systems such as database systems, file 
systems and email systems from the dynamic web page. 
Background Information 

A way of communicating information on the World Wide Web 
(WWW) is through web pages. A web browser allows a user to 
request a web page from a web server, for example, by specifying 
a universal resource locator (URL) . A URL is a pointer to a 
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resource, for example, a web page Located on a network such as 
the WWW- Conventional web pages are created through the use of 
Hypertext Markup Language (HTML) . HTML is an authoring software 
language for creating web pages. Conventional web pages, 
5 however, are generally stored as static files. 

Although utilizing web pages that are stored as static files 
has generally been accepted, a need for providing information 
which is dynamically generated and the ability to alter and 
manipulate other systems in an efficient and costly manner is 
10 needed. 

Summary Of The Invention 

An object of the present invention is providing a method and 
apparatus for providing dynamic output from other systems. 

It is another object of the present invention to provide a 
15 method and apparatus for communicating with other systems for the 
manipulation and alteration of those systems. 

Another object of the present invention provides a method 
for creating tags which provide dynamic output information from 
other systems . 

20 An aspect of the present invention provides a method for 

generating dynamic output from a system. The method includes a 
web browser providing a web browser request, e.g., a hypertext 
transfer protocol (http) request, to a web server. The method 
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also includes the web server determining whether a dog file, 
e.g., a file that includes components that can be compiled into 
specific implementations of the requirement that an execute 
method that operates on a context and a symbol table while 
5 returning a status exists, is being requested by the web browser 
request. If the dog file is not being requested, the web server 
provides to the web browser a response to the web browser 
request. If the dog file is being requested, the web server 
provides a web server request to a dog server. In this case, the 

10 dog server provides a dog file extraction request to a dog 

kennel, the dog kennel provides a copy of a compiled dog file to 
the dog server, and the dog server executes the compiled dog file 
and provides the dynamic output as a result of the execution of 
the compiled dog file to the web browser. 

15 Another aspect of the present invention provides an 

apparatus for generating dynamic output from a system. The 
apparatus includes a web browser, a web server, a dbg server, and 
a dog kennel. The web browser provides a web browser request to 
the web server, the web server determines whether a dog file is 

20 being requested by the web browser request, and if the dog file 
is not being requested, the web server provides to the web 
browser a response to the web browser request. If, however, the 
dog file is being requested, the web server provides a web server 
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request to the dog server based on the web browser request. In 
this case, the dog server provides a dog file extraction request 
to the dog kennel, the dog kennel provides a copy of a compiled 
dog file to the dog server, and the dog server executes the copy 
5 of the compiled dog file and provides the dynamic output to the 
web browser. 

In yet another aspect of the present invention, a method for 
creating a dog tag is provided which is associated with a class 
and a type. The method includes providing a unique tag name for 

10 the dog tag, and determining the type of the dog tag. The method 
also includes assigning the dog tag to a package and extending 
the class for the type of the dog tag. The method also includes 
implementing an execute method for the dog tag, importing a 
library, and providing a constructor. The method further 

15 includes creating a file implementing the steps of providing a 
unique tag name, and determining the type of the dog tag. The 
created file also implements the steps of assigning the dog tag 
to the package and extending the class of the type of the dog 
tag. The method further includes implementing the execute 

20 method, importing a library, and providing the constructor. 
Brief Description Of The Drawings 

FIG. 1 illustrates a functional block diagram of a conventional 
computer system. 
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FIG. 2 illustrates an exemplary embodiment of a functional block 
diagram of a system according to an embodiment of the present 
invention. 

FIG. 3 illustrates an exemplary flowchart for a web browser 
5 providing a request to a web server according to an embodiment of 
the present invention. 

FIG. 4 illustrates an exemplary flowchart for a web server 
processing a request from a web browser according to an 
embodiment of the present invention. 
10 FIG. 5A illustrates an exemplary flowchart for a dog server 
processing a request from the web server according to an 
embodiment of the present invention. 

FIG. 5B illustrates an exemplary flowchart for a dog kennel 
processing a dog file extraction request from a dog server 
15 according to an embodiment of the present invention. 

FIG. 6 illustrates an exemplary flowchart for a dog server 
processing a compiled dog file provided by a dog kennel according 
to an embodiment of the present invention. 

FIG. 7 illustrates an exemplary flowchart for a web browser 
20 interpreting a response to its request according to an embodiment 
of the present invention. 

FIG. 8 illustrates an exemplary flowchart for creating a custom 
dog tag according to an embodiment of the present invention. 
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Detailed Description 

FIG. 1 illustrates a conventional computer system 101 in 
which the present invention operates. In an exemplary 
embodiment, the present invention may be implemented on SUN™ 
5 Workstations manufactured by SUN MICROSYSTEMS™, IBM™ Personal 
Computers manufactured by IBM Corporation and/or a MACINTOSH™ 
computers manufactured by APPLE™ Computer. In a preferred 
embodiment, the present invention is implemented on computer 
systems operating on a UNIX platform and Java virtual machine. 
10 Further, the computer systems may communicate with each other 
through a data communication network such as the Internet (not 
shown) . It will be apparent to those of ordinary skill in the 
art that other computer system architectures may also be 
employed. 

15 m general, such computer systems as illustrated by FIG. 1 

includes a bus 102, for example for communicating information, a 
processor 103 such as a central processing unit coupled with the 
bus 102 for processing information, and a main memory 104 coupled 
with the bus 102 for storing information and instructions for the 

20 processor 103. A read-only memory 105 is coupled with the bus 
102 for storing static information and instructions for the 
processor 103. A display device 106 coupled with the bus 102 
displays information for a developer and an alphanumeric input 
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device 107 coupled with the bus 102 communicates information and 
command selections to the processor 103. A modem 110 is coupled 
with the bus 102 provides communication with, for example, other 
computer systems or databases and a mass storage medium 108, such 
5 as a magnetic disk and associated disk drive coupled with the bus 
102 for storing information and instructions. A data storage 
medium 109 containing digital information is configured, for 
example to operate with a mass storage medium 108 to allow 
processor 103 access to the digital information on data storage 
10 medium 109 via bus 102. In addition, a CD-ROM drive (not shown) 
may also be used for the storage of high resolution images for 
display on the display device 106. 

An embodiment of the present invention is implemented, for 
example, as a software module written in JAVA which may be 
15 executed on a computer system such as computer system 101 in a 
conventional manner. In an exemplary embodiment of the present 
invention, the database connectivity is written to the JAVA 
Database Connectivity Standard (JDBC) to ensure it will connect 
successfully to any JDBC- compliant database server. Using well 
20 known techniques, the application software of the preferred 

embodiment is stored on data storage medium 109 and subsequently 
loaded into and executed within the computer system 101. Once 
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initiated, the software of the preferred embodiment operates, for 
example, in the manner described below. 

In an exemplary embodiment of the present invention, a dog 
element template is a description of the requirement of an 

5 execute method that operates on a context and a symbol table 

while returning a status exists. A dog element, for example, is 
a specific implementation of the dog element template, e.g., a 
dog element is a specific implementation of the requirement that 
an execute method that operates on a context and a symbol table 

10 while returning a status exists. 

In an exemplary embodiment of the present invention, a dog 
tag is a tag that is identified and processed to create a dog 
element, e.g., a tag that is identified and processed to create a 
specific implementation of the requirement that an execute method 

15 that operates on a context and a symbol table while returning a 
status exists. In an exemplary embodiment of the present 
invention, dog tags may include a beginning tag, a dog tag body, 
and an end tag. The beginning tag may include a tag name and 
optional parameters. The dog tag body may include other dog 

20 tags. The syntax of the dog tag and a variable are different. 

In an exemplary embodiment of the present invention, the dog tag 
syntax is based on HTML with an additional identifying character 
located within the tag, for example, an exclamation point ("!") 
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located at the beginning of the tag name. The identifying 
character identifies the tag as a dog tag which should be 
executed by the parser, for example, the dog server 203. 

In an exemplary embodiment of the present invention, there 

5 are several major types of dog tags which include a first type of 
dog tag, e.g., a tag that includes a beginning tag, and optional 
parameters that is compiled into a standalone tag. A second type 
of dog tag includes a beginning tag, a dog tag body, an end tag 
and optional parameters that is compiled into a container tag. A 

10 standalone tag performs execution based on the optional 

parameters defined by the tag. In contrast, a container tag 
performs execution based on the optional parameters and the dog 
element body of the container tag. The dog element body is the 
dog tag body of the second type of dog tag after it has been 

15 compiled. The dog element body, for example, of the container 
tag may include dog elements which may also get executed while 
the container tag is being executed. 

In an exemplary embodiment of the present invention, the dog 
element body may include a plurality of dog elements. Each 

20 container tag includes, for example, a means for compiling a dog 
tag body to a dog element body. Further, the execution of a 
container tag executes all the tags embodied within it. In an 
exemplary embodiment of the present invention, there are several 
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classes of variables which include reserved variables (variables 
preset by the dog server and web server request) and user-defined 
variables (variables set and modified by the initial web browser 
request and execution of the dog elements) . Further, there are 
5 several types of variables for each of these classes which 
include text variables, list variables and file variables. 
In an exemplary embodiment of the present invention, a dog file 
is a file that includes components that can be compiled into 
specific implementations of the requirement that an execute 

10 method that operates on a context and a symbol table while 
returning a status exists. A dog file may be a text file 
designated with a dog file extension such as ".dog". In an 
exemplary embodiment of the present invention, the dog file is a 
UNIX file. The dog file may be, for example, a static file that 

15 includes dog tags and standard hypertext markup language (HTML) . 

In an exemplary embodiment of the present invention, a dog 
server 203 is a server that requests and executes the plurality 
of dog elements, e.g., a server that requests and executes 
specific implementations of the requirement that an execute 

20 method operates on a context and a symbol table while returning a 
status exists. A dog kennel 204 performs compilation on the dog 
file, stores the tree of dog elements (compiled dog file) , and 
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provides a copy of the compiled dog file to the dog server 203 to 

be executed on. 

An implementation of a requirement can be utilized without 
having knowledge of the specific implementation. Thus, in an 
5 exemplary embodiment of the present invention, a server can 
utilize the execution method of the dog element to generate 
dynamic output through interactions with external systems without 
having to know the implementations of that method. 

FIG. 2 illustrates a block diagram of an exemplary 

10 embodiment of the present invention. Each of the web browser 
201, web server 202, dog server 203 including a communication 
manager 206, and dog kennel 204 may be provided on, for example, 
conventional computer systems 101 as shown in FIG. 1. As shown 
in FIG. 2, web browser 201 requests information from a web server 

15 202 based upon an http request. When web browser 201 makes a 
request, it includes not only the desired web page, but also 
additional information necessary to process the request. For 
example, the additional information may include a user 
identification, password, and any other information collected by 

20 the web browser. 

The web server 202 processes the request from web browser 
201. Based upon the request, the web server 202 will provide 
either a file to the web browser 201 or a request for a dog file 
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to a dog server 203. In the case of a web server 202 providing a 
request to the dog server 203, the web server 202 may also 
provide a point of entry for receiving a response to the request 
of the web browser 201. 

5 Referring to the block diagram of FIG. 2, upon receiving the 

request from the web server 202, the dog server 203 processes it. 
The dog server 203 provides the dog kennel 204 with a dog file 
extraction request. The dog kennel 204 serves as a central 
repository for storing the existing compiled dog files 205, 

10 compiling new dog files, and storing the newly compiled dog files 
therein. The dog kennel 204 processes the extraction request and 
provides the dog server 203 with a copy of the tree of dog elements 
(compiled dog file) 205. The dog server 203 processes the compiled 
dog file 205 and provides a dynamic output response to its 

15 communication manager 206. The communication manager 206 of the dog 
server 2 03 manages the output response and may provide a response to 
the web browser's request through the point of entry provided by the 
web server 202. The web browser 201 interprets the response. 

FIG. 3 illustrates an exemplary flowchart for a web browser 201 

20 providing a request to a web server 202 according to an embodiment 
of the present invention. The exemplary flowchart of FIG. 3 can be 
implemented, for example, in software that is stored in, for 
example, memory of a general purpose computer system 101 as shown in 
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FIG. 1 and that executes on the processor of the general purpose 
computer 101. 

The user's request may be provided to the web browser 201 by 
entering a page address as shown in step 301, clicking a hypertext 
5 link as shown in step 302, submitting an HTML form as shown in step 
303, or selecting a bookmark as shown in step 304. Further, a user 
may be redirected to a new address from which a request to the web 
browser 201 may be supplied as shown in step 305. The request 
supplied by the user to the web browser 2 01 may include a request 

10 for a web page, a request for a dog file, and/or for additional 
information. In step 306, the web browser 201 determines and 
locates the server that includes, for example, the desired web page. 
In step 3 07, the web browser 2 01 sends a request to the web server, 
for example, for the web page with the information requested by the 

15 user. 

FIG. 4 illustrates an exemplary flowchart for a web server 202 
processing a request from a web browser 201 according to an 
embodiment of the present invention. The exemplary flowchart of 
FIG. 4 can be implemented, for example, in software that is stored 
20 in, for example, memory of a general purpose computer system 101 as 
shown in FIG. 1 and that executes on the processor of the general 
purpose computer 101. 

In step 401, the web server 202 receives the request from the 
web browser 201. In step 402, the web server 202 determines whether 
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a dog file is being requested. In an exemplary embodiment of the 
present invention, the extension of a file is analyzed to determine 
the file type. In step 403, files which can be interpreted by the 
web browser 201 such as HMTL files (html extension) , text files (txt 
5 extension), Graphics Interchange Format files (gif extension), and 
Joint Photographic Experts Group files (jpg extension), are sent to 
the web browser 201 from, for example, the web server 202. The 
request for dog files which can not be interpreted by a web browser 
201 (e.g., file having a dog extension), however, is sent to the dog 

10 server 203 in step 404. 

FIG. 5A illustrates an exemplary flowchart for a dog server 203 
processing a request from the web server 202 according to an 
embodiment of the present invention. The exemplary flowchart of 
FIG. 5A can be implemented, for example, in software that is stored 

15 in, for example, memory of a general purpose computer system 101 as 
shown in FIG. 1 and that executes on the processor of the general 
purpose computer 101. 

In step 501, the dog server 203 receives the request from the 
web server 202, for example, for a dog file. The dog server 203 may 

20 perform pre-processing as shown in step 502. In an exemplary 

embodiment of the present invention, pre-processing may include 
verifying that the requested file exists, for example, on a file 
system; performing security measures; and allocating resources 
necessary for the compilation of the dog file and the execution of 



SUBSTITUTE SHEET (RULE 26) 



WO 00/25223 PCT/US99/251 59 

15 



the compiled dog file. The security measures performed may include 
determining that the user making the initial request to the web 
browser 201 has access to any necessary sources such as a database 
necessary to complete the request. 
5 Access can be determined based on the additional information 

provided by the user such as the user identification and password. 
Allocation of resources may include establishing a communication 
link with a source such as a database needed to complete the 
respective compilation and/or execution. In an exemplary embodiment 

10 of the present invention, the file system is a resource provided by 
UNIX platform to access, for example, data storage medium 10 9 as 
shown in FIG. 1. If the file requested can not be verified, an 
indication such as an error message would be provided by the dog 
server 203. In step 503, the dog server 203 provides an extraction 

15 request to the dog kennel 204 for the extraction of a dog file. 

FIG. 5B illustrates an exemplary flowchart for a dog kennel 204 
processing a dog file extraction request from a dog server 203 
according to an embodiment of the present invention. The exemplary 
flowchart of FIG. SB can be implemented, for example, in software 

20 that is stored in, for example, memory of a general purpose computer 
system 101 as shown in FIG. 1 and that executes on the processor of 
the general purpose computer 101. 

In step 510, the dog kennel 204 receives the dog file 
extraction request. In step 511, the dog kennel 204 determines 
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whether the compiled dog file is in the dog kennel 204. If so, the 
dog kennel 204 provides a copy of the compiled dog file 205 to the 
dog server 203 as shown in step 514. If the dog file is not in the 
dog kennel 204, the dog kennel 204 loads the dog file from a system 

5 such as the respective file system at which it may be stored as 

shown in step 512. In step 513, the dog file is compiled, that is, 
the execution steps of the compiled dog file are determined and 
stored as a tree of dog elements (compiled dog file) . The compiled 
dog file 205 is provided to the dog kennel 204 as shown in step 515 

10 and a copy of the compiled dog file is provided to the dog server 
203 . 

In an exemplary embodiment of the present invention, the 
compilation of a dog file includes the dog kennel 204 identifying 
components such as raw text, beginning tags and end tags within the 

15 dog file. The respective dog elements created are based on the 

order of the identified components in the dog file. The creation of 
a dog element includes, for example, identifying the tag name within 
the beginning tag and determining the package which includes the dog 
elements from a list of known packages. In an exemplary embodiment 

20 of the present invention, the dog kennel creates the list of known 
packages at initialization. Based on the identified package and tag 
name, the implementation of the dog element is dynamically created 
with its execution method. 
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The tree of dog elements is, for example, an abstract 
representation of the execution steps of the entire dog file. For 
example, the execution of the dog file is the sum of the execution 
of each of the dog elements. In an exemplary embodiment of the 
5 present invention, a dog tree element has a constructor which may 
take a parameter object and an execute method. A dog element may 
take one of the several forms including a standalone tag, a 
container tag, an expression and an error element. The error 
element provides an indication of a compiler error, while an 

10 expression is a dog element that is raw text and simply undergoes 
variable substitution. The execute method of a dog element is the 
set of instructions that are performed when the element is executed. 
In the exemplary embodiment of the present invention, the 
instructions that the execution method may include are any set of 

15 instructions that can be programmed with, for example, the JAVA 

language. A set of instructions may be provided, for example, to 
interface, alter, and manipulate external systems. Further, the 
execute method operates on two objects a context and a symbol table. 
A context is a group of communication elements used by the 

20 execution method of the dog elements. The communication elements 
are the means by which the execution method interacts with other 
systems and/or communication manager 206. In an exemplary 
embodiment of the present invention, the context may include a JDBC 
connection to a database and an output stream to the communication 
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manager 206. The symbol table is the environment in which dog 
element can execute on. The environment serves the purpose of the 
storage of all variables, e.g., preset and user-defined, in addition 
to their values. A symbol table includes all the variables that 
5 have been set and modified in previous dog element executions. 
Since the environment is not a fixed entity, it can be used to 
generate dynamic output using the execute method. 

The execution of the dog element also provides a status object 
that indicates the completion state of the execution, e.g., whether 

10 the execution was successful. In an exemplary embodiment of the 

present invention, the status may be exit (e.g., halt and do no more 
after the execution of the respective dog element), abort (e.g., 
stop execution and undo the execution of the other dog elements in 
the respective compiled dog file 205), and proceed (e.g., continue). 

15 FIG. 6 illustrates an exemplary flowchart for a dog server 203 

processing a compiled dog file 205 provided by a dog kennel 204 
according to an embodiment of the present invention. The exemplary 
flowchart of FIG. 6 can be implemented, for example, in software 
that is stored in, for example, memory of a general purpose computer 

20 system 101 as shown in FIG. 1 and that executes on the processor of 
the general purpose computer 101. 

In step 601, the dog server 203 analyzes the compiled dog file. 
The analysis may include, for example, a determination of the output 
format, management strategy of the communication, and whether or not 
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to open communication to either external systems . In the exemplary 
embodiment of the present invention, the output format may include 
standard mime types such as html3.2, ASCII, javascript™, and rtf. 
In step 602, the dog server 203 may open communication to other 

5 systems based on analysis of the compiled dog file. In the 

exemplary embodiment of the present invention, the database to which 
the dog server 2 03 establishes communication with may be 
predetermined and provided in the configuration of the dog server 
203. In step 603, the dog server 203 initializes the symbol table, 

10 e.g.. the environment in which data is stored to be accessed and 
modified by the dog elements. For example, input variables 
including preset variables and user-defined variables such as 
variables passed in from the web browser request. 

In step 604, the compiled file is executed. In an exemplary 

15 embodiment of the present invention, the execution will include each 
dog element of the compiled dog file 205 being recursively executed. 
When execution occurs, the dog server 203 is given the environment 
to execute on and a way to generate an output response (such as 
HTML) . Each execution of a dog element of the compiled dog file 205 

20 may modify the environment causing executions of other dog elements 
to execute differently. Accordingly, dynamic information may be 
generated. Further, the dog tags are dynamically created, that is, 
the dog tags do not have to be defined at the point of time the dog 
server 203 is opened. Thus, the dog server 203 does not need to 
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know all information about the dog tag. Also, the use of the dog 
tags and execution of the compiled dog tag file allow other systems 
to be interfaced, manipulated, and altered through the use of the 
execute method of each dog element. In an exemplary embodiment of 

5 the present invention, the other systems may include database 
systems, email systems and file systems. 

In an exemplary embodiment of the present invention, the 
communication manager 206 of the dog server 203 controls the dynamic 
output response from the execution of the dog tree elements. The 

10 dynamic output response is the set of information that is generated 
by the execution of the dog element tree, e.g., the compiled dog 
file. The communication manager 206 determines what format to 
provide the dynamic output to the web browser 201 based on the 
output response it receives. For example, if the dynamic output 

15 response includes binary information about an image, the 

communication manager 206 may provide the actual image itself as 
opposed to HTML that describes the image. The output response 
may occur during the execution of the compiled dog file or it may 
be buffered and provided upon completing the execution of the 

20 compiled dog file. 

In an exemplary embodiment of the present invention, the 
communication manager 206 of the dog server 203 captures and 
manages the dynamic output response, determining when the dynamic 
output should be provided to the web browser 201 through the 
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point of entry, e.g., portal, provided by the web server 202 as 
shown in step 606 . In an exemplary embodiment of the present 
invention, the web server 202 does not provide any interpretation 
or modification of the dynamic output. Thus, the communication 
5 manager 206 has the ability to nullify the actions of the 

execution of a dog element prior to passing the dynamic output to 
the web browser 201. This may be desired, for example, if the 
execution of a latter dog element is unsuccessful, although 
execution of a previous dog element of the same compiled dog file 

10 205 was successful. 

After the execution of the compiled dog file, e.g., the tree 
of dog elements, the dog server 203 may perform post -processing 
as shown in step 605. In an exemplary embodiment of the present 
invention, post-processing may include closing established 

15 communications, flushing all output streams, and finalizing the 
request from the web server. 

FIG. 7 illustrates an exemplary flowchart for a web browser 
201 interpreting a response to its request according to an 
embodiment of the present invention. The exemplary flowchart of 

20 FIG. 7 can be implemented, for example, in software that is 
stored in, for example, memory of a general purpose computer 
system 101 as shown in FIG. 1 and that executes on the processor 
of the general purpose computer 101. 
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In step 701, the web browser 201 receives the response from 
the dog server 203 through the web server. In step 702, the web 
browser 201 determines the format of the response provided by the 
dog server 203 through the web server 202. In step 703, the web 
5 browser 201 displays, for example, on the display device 106 
shown in FIG. 1, the information provided by the response it 
received from the dog server 203 through the web server. 

An exemplary embodiment of the present invention includes core 
dog tags listed in the attached Appendix. An implement er, however, 

10 may create custom dog tags. FIG. 8 illustrates an exemplary 

flowchart for creating a custom dog tag according to an exemplary 
embodiment of the present invention. In an exemplary embodiment of 
the present invention, a dog tag is created by providing a tag name 
as shown in step 801. The tag name must be unique, that is, it may 

15 not be one that is already associated with a dog tag. A tag name is 
the text used by an author to define a tag and the respective 
parameters. In step 802, the type of dog tag to be created, for 
example, the first type of tag (a tag that is compiled into a 
standalone tag) or the second type of tag (a tag that is compiled 

20 into a container tag) is determined. If the type of dog tag being 

created requires parameters, parameters are provided including their 
respective types as shown in step 803. For example, parameter types 
may be a literal, expression, number, list of identifiers, single 
identifier, and empty. An empty type parameter affects the behavior 
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of the respective tag based on whether a parameter is present, not 
on the value of the parameter. The dog tag being created is 
assigned to a tag package as shown in step 804. In an exemplary 
embodiment of the present invention, it may be either assigned to an 
5 existing tag package or a new package which is added to a list of 
potential tag packages. 

In step 805, the class for the type of dog tag being created is 
extended, which gives the newly created class the same functionality 
of the class being extended. In the exemplary embodiment of the 

10 present invention, extending a class, for example in JAVA, provides 
a means to identify the type of dog tag while compilation occurs. 
In step 806, the execute method for the dog tag being created is 
implemented. In an exemplary embodiment of the present invention, 
the execute method would include a set of instruction provided by 

15 the implementer and written, for example, in the JAVA language. The 
set of instructions would allow the dog tag to provide a desired 
function as determined by the implementer such as to interface with 
other systems. Further, the execute method operates on the context 
and symbol table. Since the symbol table, e.g., the environment on 

20 which the execution method executes, may change prior to the 

execution method being performed, dynamic output may be generated. 
For example, the symbol table may have changed as a result of the 
execution of a prior dog element. 
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in step 807, a library is imported. The library, for example, 
com.cpm.dog, may include the objects necessary to implement the 
basic functionality of the dog tag. For example, the class, 
context, symbol table, and parameters. In an exemplary embodiment 
5 of the present invention, an input /output (I/O) handling package, 
for example, javaio . IOException is also imported. In step 808, a 
constructor is provided. In an exemplary embodiment of the present 
invention, the constructor may include the ability to capture error 
messages such as those provided by an I/O handling package regarding 

10 the creation of the compiled dog file. In step 809, a file is 

created, such as a JAVA file, implementing the steps of providing a 
unique tag name as shown in step 801, determining the type of dog 
tag as shown in step 802, providing parameters and the parameters 
respective types as shown in step 803, assigning the dog tag to an 

15 existing package as shown in step 804, extending the class of the 
type of dog tag as shown in step 805, implementing the execute 
method as shown in step 806, importing a library as shown in step 
807, and providing a constructor as shown in step 808. In an 
exemplary embodiment of the present invention, a step of importing 

20 an I/O handling package may be implemented by creating the file. In 
an exemplary embodiment of the present invention the dog tag is 
compiled as shown in step 810. Further, if the package the dog tag 
was assigned to, e.g., created in, is not in an existing package, 
the dog server must be configured with the location of the package 
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and be restarted as shown in step 811. The compilation provides the 
file created in step 809 in a form that can be used by the JAVA 
virtual machine . 

The embodiments described above are illustrative examples of 
the present invention and it should not be construed that the 
present invention is limited to these particular embodiments. 
Various changes and modifications may be effected by one skilled in 
the art without departing from the spirit or scope of the invention 
as defined in the appended claims. 



10 
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Author Reference 
Variable Tags 



<!SET> 

This standalone tag sets die contents of one or more user variables. Use the name of the variable y< 
to set as the parameter name, and the expression you want to set it to as its parameter value. 



Format: 



<!SET vamame=varvalue> 



Parameters: 



^JpracnTSlariable being set in tins tag will be treated as a list. Hie value assigned to it will be added 
to the end of the list, rather tiian replacing the whole pre-existing value. 

DEFAULT (empty) . t , ^ . . , n . 

If present, SET will not replace any pre-existing value held by the variable. That is, it will perform its 
duty on the named variable only if it is currently blank. 

REP ARSE (empty) ^ ... . . , 

If present, after SET lias finished evaluating an expression in preparation for assigning it to a variable, it 

will evaluate it a second time. 

VARTYPE (literal choice) . . AT v™™ t ic-r 

Optional, default is "text". Value must be "text", "list", or "file" (case insensitive). If VARTYPE-LIST 
is specified SET will read die given expression as a comma-separated list and will create a list variable 
containing the items in tliat list. For VARTYPE=FELE, SET will look for a file with the given name on the 
server and create a file variable if it is found. 



Examples: 

<!SET name=Jack> 

<!SET greeting="He!lo, {name}P> 

Now the variable greeting contains "Hello, Jack!". 

Any existing value held by the variable will be overwritten in favor of its new value, even if the new value 
is blank. The following three statements all liave the effect of clearing die contents of die foo variable: 



<!SETfoo= w,, > 
<!SET foo=> 
<iSETfoo> 



Another example: 

<!SETfoo=bar> 

<ISET foo=bat APPEND> 

Now foo is a list variable containing "bar" and "bat" as elements. 



<!SETfoo=> 
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(now foo is empty) 
<!SET foo=bar DEFAULT> 

(now foo is set to "bar") 
<!SET foo=bat DEFAULT> 

(foo is still set to "bar") 
<!SETfoo^bat> 

(now foo is set to "bat") 



<!SETage=42> 

<!SETphrase="You are {Ibracc}agc(rbracc} years old."> 

Hie variable phrase now contains "You arc {age} years old.". In order to have "42" substituted for "{age}", 
we must reparse the expression: 

<ISETphrase="You are {lbrace}agc{rbrace} years old." REPARSE> 

After the first evaluation, die value of plirase would be, "You arc {age} years old". Tliis expression is then 
evaluated again, so tliat phrase now contains, "You arc 42 years old". 

<!SET foo="foo, bar, baz"> 

(Now foo is literally "foo, bar, baz") 

<1SET foo="foo, bar, baz" VARTYPE=LIST> 

(foo is now a list containing three elements: "foo", "bar", and "baz") 

NOTE: If an equals sign is found after an APPEND, DEFAULT, or REPARSE tag, it will be treated as a 
variable name to be set instead of afTccting the overall behavior of SET. If VARTYPE lias any value other 
than "text," "list, " or "file," it should also be treated as a variable to be set. 

SET does have a single anomaly: you cannot use it to dtrccUy set a variable named "vartypc" to the value 

"text", "list", or "file". 

To do so, use a construct such as: 



<!SET tmp=text> 

<! SET vartype=" { Imp } "> 

<!SETtmp=""> 

You can actually specify as many variable identifiers as you wish as parameters to SET. Each new value 
that is specified is treated as an expression (see "Parameter Types") which may contain variables itself. 
This expression will be evaluated and the results of the evaluation will be stored in the new variable. Any 
additional parameters you have specified (DEFAULT, VARTYPE, etc.) will apply to all variables being set 
within the tag. Caution: The order in which the variables will be set is not defined 



<1SETVAR> 

This standalone tag performs the same basic function as SET in a different manner wluch is more suitable 
for some situation's. 

Parameters: 

NAME (expression) 

Required. The variable name that should be set 
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VALUE (expression) . 
Required. Tlic value dial should be assigned to Uic named variable 

Examples: 

<QUERY SQL=" 

SELECT Var_Name, Var_Value 
FROM DataJTabie 

•> 

<EACHROW> t ii( 

<SETVAR NAME="{var_nanie}" VALUE="{var_value} > 

<£ACHROW> 
<QUERY> 



<CLEAR> 

This standalone tag undefines a set of variables. 
Parameters 

VARS Gist of identifiers) 

Required. The variable names whose contents should be cleared (that is, set to 

Examples: 

<! CLEAR VARS=namc,address,city t statc,zip> 



<!EACHVAR> 

EACHVAR is a container tag that loops dirough a series of variables determined by the parameters giy< 
Regardless of the parameters, though, the behavior each time dirough die loop is die same. It will set th 
reserved variable dog.namc to the current variable name and dog.valuc to die current variable value. TIi 
variables arc cleared when die loop finishes. 



Parameters: 

ALL (empty) . 
If present, EACHVAR loops through all user and reserved variables. Otherwise, it only loops through 

all user variables. 



PREFIX (expression) 

Optional If specified, the expression is evaluated and then EACHVAR loops through all variables that 
begin with that sequence of letters. When PREFIX is specified, both user variables and reserved variables 
can be accessed just the same, depending only on the prefix you specify. 



Examples: 

To loop through the Java system properties: 



<JL> 

<!EACHVAR PREFIX=sys.> 
<U>{dog.name} » {dog.value} 
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</!EACHVAR> 
«UL> 



<!EACHITEM> 

EACHTTEM like EACHVAR, is a container lag that results in a loop. Instead of looping UiroughjuM 
variables though, it loops tlirough all elements in one particular list variable. Inside the EACHITEM block, 
iie^urrent element of the list can be accessed in the same variable that references the whole list outside the 
block. 

Parameters: 

LIST (identifier) 

Required. The list variable to examine. 

Examples: 

^SETfoo^Too, bar, baz" VARTYPE=Iist> 
{foo}<BR> 

<!EACHITEM LIST=foo> 

{foo}<BR> 
</!EACHTTEM> 
{foo}<BR> 

produces tlte following output: 

Ifoo ? bar f baz]<BR> 

foo<BR> 

baKBR> 

baz<BR> 
Jfoo, bar, baz)<BR> 

Remember tlie LIST parameter takes an identifier, not an expression, so curly braces arc not used. 



Conditional Tags 
<1IFDEF> 

IFDEF is a container tag that causes its block to be executed only if a given variable or variables are 
nonempty. 

Parameters: 

IFDEF has no parameters other than the variable names you wish it to check. Any number of variables can 
be specified. The statements enclosed by IFDEF will be executed if at least one of the identifiers specified 
is defined. 



Examples: 

<lSETfoo=bar> 
<lIFDEFfoo> 

Hello 
</IJfDEF> 
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<!SETfoo=> 
<!IFDEF foo> 

Goodbye 
</!IFDEF> 

This will display "Hello" but not "Goodbye". 

<!SETa="" b= M " c=l> 
<!IFDEF a b O 

Yes! 
<7!IFDEF> 

This will produce the output "Yes!" IFDEF implicitly performs an "OR" between the named variables: "If a 
is set OR b is set OR c is set" Note that an equivalent "AND" capability is not needed because IFDEF tags 
can nest inside each other like this: 

<!IFDEF a> 

<! IFDEF b> 
Yes, both a and b arc set! 

</!IFDEF> 
<\WDEF> 

An error results if IFDEF is used without naming any variables. 



<!IFNDEF> 

IFNDEF is a container tag tliat performs the exact opposite function of IFDEF, The statements it encloses 
are executed if and only if the variable named is undefined, tliat is, lias a value of"". 

Parameters: 

IFNDEF has no parameters other than the variable names you wish it to check. Any number of variables 
can be specified. The statements enclosed by IFNDEF will be executed if at least one of the identifiers 
specified is undefined. 

Just like IFDEF, when multiple variables are specified, IFNDEF performs an OR: "If a is not set OR b is 
not set OR c is not set." Tins ensures a specific set of values lias been filled in. 

Examples: 

<!IFNDEF name age address city> 

Error! You must fill in all the required fields. 
</!IFNDEF> 

An error results if IFNDEF is used without naming any variables. 



<!IFEQ> 

IFEQ is a container tag that works very similarly to IFDEF and IFNDEF. The simplest use of IFEQ is to 
test whether two variables have die same value. The names of these two variables are given as parameters. 
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and IFEQ will cause the enclosed statements to be executed only If the contents of those variables arc the 
same. 

Parameters: 

IFEQ has no parameters other tlian the variable names you wish it to check. Any number of variables can 
be specified. The statements enclosed by IFEQ will be executed if all the named variables arc equal to each 
other. 

Examples: 

<!SET foo="A phrase"> 
<!SET bar= M Another plirase"> 
<!SET baz^ Another -plusse'^ 
<!IFEQ foo bar> 

"These words will not appear. 
<!IFEQ> 
<!IFEQbarbaz> 

These words will appear! 
</!IFEQ> 

You can specify more tlian two variables. The enclosed statements arc executed if and only if all the named 
variables are equal to each other. 

<!IFEQ foo bar baz> These words will not appear. </!IFEQ> 

An error results if EFEQ is used without naming at least two variables. 



<!BFIN> 

This container lag executes its block if and only if a given element is found in the named list variable. 
Parameters: 

LIST (identifier) 

Required. The name of the list-type variable to examine. 

ELEMENT (expression) 

Required. After tlus expression is evaluated, the resulting text will be searched for in the named list 
variable. 

Examples: 

<!SETalist="foo, bar, baz" VARTYPE=LIST> 
<IIFIN LIST>alist ELEMENT=bar> 

This sentence will appear in the output 
</lIFIN> 
<!SETatextFba> 

<1IFIN LIST=alist EUEMENT=" {atext }z"> 

As will this one. 
</!IFIN> 

<!MN LIST^alist ELEMENT=test> 

But not this one. 
<iJFW> 



SUBSTITUTE SHEET (RULE 26) 



WO 00/25223 PCT/US99/25I59 

32 



<!SWitch> 

<!CASE> 
<!DEFAULT> 

SWITCH is a container lag inside which any number of standalone CASE tags may appear, optionally 
followed by one standalone DEFAULT tag. CASE and DEFAULT may appear only immediately inside a 
SWITCH tag and may not be contained by any oilier container tag. 

Format* 

<!SWITCH VALUE-"{somevarr> 
<!CASE VALUE=flrstiiteral> 

... statements ... 
<!CASE VALUE=sccondliteral> 

... statements ... 
<!CASE VALUE=thirdlitcrat> 

... statements ... 
<!DEFAULT> 

... statements ... 
</!SWITCH> 

Parameters: 

(SWITCH tag) 

VALUE (expression) 

Required. Evaluated immediately. The resulting value will then be compared, one by one, to the 
VALUE parameter of 
each enclosed CASE tag. 

(CASE tag) 

VALUE (literal) 

Required, If this literal matches the SWITCH value, the statements following this CASE tag will be 
executed until the next , , or tag is reached. 

(DEFAULT tag) 

No parameters. If no matching CASE was found, the statements following this tag and preceding the end of 
the SWITCH block will be executed. 

Examples: 

Hie number you have entered is 
<1SWTTCH VALUE= H {number}"> 

<!CASE VALUE=1> one. 

<!CASE VALUE=2> two. 

<!CASE VALUE=3> three. 

<!CASE VALUE=4> four. 

<1CASE VALUE=20> twenty. 
<1DEFAULT> not a whole number between 1 and 201 
<1SWTTCH> 
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One common use of the SWITCH tag is to consolidate awkward statements like: 

<!1FNDEF foo> 

Do litis 
</!IFNDEF> 
<!IFDEFfoo> 

Dotliat 
<!IFDEF> 

into: 

<!S\VTTCH VALUE="{foo}"> 
<!CASE VALUE=>Do this 
<!DEFAUL1>Do that 

<y!SwrrcH> 



<!RANDOM> 
<IITEM> 

The RANDOM container tag and ITEM standalone tag allow you to have statements randomly selected 
from a group to be executed. RANDOM works much like die SWITCH tag, except there is no DEFAULT 
option, and the block of statements to be executed is up to chance instead of the value of an expression. 
ITEM can appear only immediately inside a RANDOM tag. If no ITEM tags arc in a RANDOM block, or 
all the ITEM tags there have WEIGHT=0, RANDOM will produce an error. 

Parameters: 
WEIGHT (number) 

Optional, default T. Allows you to configure certain choices to be more likely to be chosen than 
others. It is iegal to specify WEIGHT=0, but then the statements following that ITEM tag would never be 
chosen. 

Examples: 

You are rolling a six-sided die. You rolled a 
<!RANDOM> 

<!ITEM>one! 

<!ITEM>two! 

<!ITEM>threel 

<!ITEM>fourl 

<!rmM>five! 

<lITEK£>six! 
<yjRANDOM> 

Now you're rolling two four-sided dice. You rolled a 
<!RANDOM> 

<!ITEM WEIGHT=l>two! 

<1I1BM WEIGHT=2>three! 

<!ITEM WEIGHT=3>fourl 

<IITEM WEIGHT=4>five! 

<!ITEM WEIGHT=3>stx! 

<!ITEM WEIGHT=2>seven! 

<!ITEM WEIGHT=l>eight! 
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<!RANDOM> 

You could use RANDOM to implement a sort of "sweepstakes" whereby a few luck)' visitors to your site 
win a prize. This example gives a 1 in 10,000 chance of winning. 

<lRANDOM> 

<irreM> 

<P>You have just won a free barbecue set! Please click here 
to fill out your name and address and we will send it to you!</P> 
<!ITEM WEIGHT=9999> 
<7IRAMDOM> 

File Tags 

<1INCLUDE> 

INCLUDE is a standalone tag tliat allows you to include the contents of another document inside the 
current document 

Parameters: 

FILE (expression) 

Required. Specifies the document to be included. Either an absolute patlinamc or a paduiamc relative to 
the current document can be givea URL translation rules will not apply. If the filename ends in .dog, the 
included file will be executed by the DOGtags parser; otherwise the contents of the file will be copied to 
the output as-is. 

VARS (list of identifiers) 

Optional. Only meaningful when die FILE parameter references anodier DOGtags document (tJiat is, the 
filename ends in .dog). If specified, only copies of the variables you name will be passed into the included 
file. If the included file changes or unsets these values, or defines new variables of its own, these changes 
will not be reflected in the main file. (All reserved variables accessible in the main file can be accessed in 
the included file as well.) If VARS is absent, however, the included file will share the same variable 
memory as the main file. Variables can be set, unset, and modified inside the included file and these 
changes WILL carry over to the remainder of the main file. If the FILE specified does not end indog, the 
VARS parameter will be ignored. 

CANEXTT (empty) 

If present, and the included file executes an EXIT tag, the including file will exit as well. By default, 
EXIT tags inside included files cannot exit the including file. 

Examples: 



<IUNK> 

LINK is a standalone tag that provides a simple mechanism for creating a hyperlink to another DOGtags 
page 

Parameters: 
TEXT (expression) 

Optional The text that should appear on the screen for the user to click on. TEXT can be specified with 
or without IMG, but if neither is specified, there will be no way for the user to activate the link. 



SUBSTITUTE SHEET (RULE 26) 



WO 00/25223 



35 



PCT/US99/25159 



^oSSS^absolutc or relative URL to an image file for the user to click on. IMG can be specified 
with or without TEXT, but if neither is specified, Uicrc will be no way for the user to activate die link. 

"oSTSwataoIute or relative URL to the DOGpage you are linking to. This link should not contain 
a query string. If it is not present, an inactive hyperlink will be created; this is a good way to taKc advantage 
of the STATUS feature below even if there is no actual hyperlink involved. 

VARS (list of identifiers) t . , Tr 

Optional A comma-separated list of the variable identifiers you wish to pass into the next document. If 

it is not present, no variables will be passed. 

COLOR (expression) . 
Optional. The color you want the link to appear, cither as an accepted color name or a six-digit 

hexadecimal code. 
STATUS (expression) 

Optional. The plirasc you wisli to appear in the status bar of the Web browser when the mouse cursor is 
over the link 

TARGET (expression) t 

Optional. Specifies the window tliat the link should be opened in when clicked. 

ACTIVE (expression) . 

Optional. If this parameter is present but the expression evaluates to a blank string, this link will be 

made unclickable. 

ONCLICK (expression) 

Optional. Specifies javascript code to be invoked when this link is clicked on. 

SIZE (literal) 

Optional. The widdi and height of the named IMG, in the form wwxhh. 
Examples: 

To pass the variables client and job to another page called dctails.dog, using the default link color, using the 
concatenation of client and job as the link text, and displaying the job name in the status bar 

<!LINK URL=details.dog VARS=clientjob TEXT= M {client}(jobr 
STATUS=" {jobname} "> 



<1REDIRECT> 

REDIRECT is a standalone tag that causes the Web browser to immediately display a new URL in place of 
the current page. 

Any output which has already been produced in the current page will be discarded in favor of the new page. 

Parameters: 

URL (expression) 

Required. A relative or absolute URL to the new page. If URL is not present, or specifies an obviously 
invalid location, the REDIRECT tag will fail with an error message. 
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VARS (list of identifiers) 

Optional. A comma-separated list of the variable identifiers you wish to pass into the next document. U 
it is not present, no variables will be passed. 

ALLVARS (empty) 

If present, it is equivalent to listing ail the currently set variables in a VARS parameter. All set variables 
will be passed to the new page. 

Examples: 

<! RED ERECT URL=http://www.cpm.com/foo.dog VARS=bar,baz> 
If this message shows up, there must liave been an error 
with the redirect] 



<!DO\VNLOAD> 

Tliis standalone tag aborts the current page and causes die Web browser to begin downloading die named 
file. Any output which has already been produced in the current page will be discarded in favor of the new 
page. 



Parameters: 



FILE (expression) 

Required. A relative URL to the file to be downloaded. 

TYPE (expression) 

Optional, defaults to "application/octct-strcam". The MTME type of the file. 



Examples: 

<!IFDEF rcadytodownload> 

<!DOWNLOAD FILE=somefile.zip TYPE=appIication/zip> 
</!IFDEF> 



<!EACHFTLE> 

Hiis container tag loops tlirough all of the files present in a given directory, each time setting die variable 
dog.filcname to the current filename. 

Parameters: 

DIR (expression) 

Optional, defaults to V. The directory whose contents you wish to loop through. 
Examples: 



<!MOVE> 

This standalone tag moves (or renames) a file on the server file system. 
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Parameters: 

FILEVAR (identifier) 

Required. A DOGtags File-type variable representing the file to be renamed. 

TO (expression) 

Required. The new filename for the file. 

Examples: 



<!MKDIR> 

Tlus standalone tag creates a new directory on the server filcsystem. 

Parameters: 

DIR (expression) 

Required. The name of the directory you want to create. 

Examples: 



Database Access Tags 
<!FETCH> 

This standalone tag executes a query in Hie database which is expected to return only one row and places 
die retrieved values into DOGtags variables. 

Parameters: 

SQL (expression): Required. The SQL SELECT statement tlial should be issued to the database. Identical 
to QUERY'S SQL parameter. 

INTO Gist of identifiers): Optional. By default, FETCH stores each returned column value in a variable 
with die same name as die column name in the query. To use different variable identifiers, specify them 
here in respective order to the columns selected in the query. For each column returned diat docs not iiave a 
corresponding identifier specified in INTO, the query-based identifier will be used as usual. 

INSIST (empty): Ordinarily, if the requested row is not found in die query, FETCH will terminate normally 
widiout setting any variables or raising any errors. To indicate that a statement should always successfully 
return a row, and diat it would be an error condidon if it did not, add the INSIST parameter to die FETCH 
tag. If it is present, and die statement does not return any rows, FETCH will abort the current transacdon (if 
applicable) and set a "No rows selected" error. 

Examples: 

<1FETCH SQL-"SELECT Full_Name name, Age FROM People 

WHERE Id = 2048"> 

Hello, {name}! You are {age} years old! 



SUBSTITUTE SHEET (RULE 26) 



WO 00/25223 PCT/US99/25159 

38 



<! FETCH SQL= H 

SELECT Cat_No. (Figl + Fig2) / 2 Fig_Avg 
FROM Foo 
WHERE Id = 2404 
«> 

Hie average for {cat_no} is {fig_avg}. 

<!FETCH SQL="SELECT Name, Age, Hirc_Datc FROM Emp WHERE EmpNo = 413" 

INTO= iM einpname > empagc f emplure ,, > 

<!- sets empnainc, empage, and empliire ~> 

<!FETCH SQL= M SELECT Name, Age, Hirc_Datc FROM Emp 

WHERE EmpNo = 413" 

INTO="empname„ emphire"> 

<!~ sets empname, age, and empliire — > 

<!FETCH SQL="SELECT Name, Age, Hire_Daic FROM Emp 
WHERE EmpNo = 413" INTO=empname,empage> 
<!— sets empname, empage, and hire_date -> 

<!FETCH SQL= tt SELECT Name, Age, HireDate FROM Emp WHERE EmpNo = 413" 
INTO^foo^ 

<!— sets name, age, and hire_date -> 

<!QUERY> 

<!EACHROW> 

<!NOROWS> 

QUERY and EACHROW are a pair of container tags that function similarly to FETCH, except that they 
. can handle multiple rows being returned from the query. The contents of the EACHROW tag are executed 
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once for each row returned from the query. EACHROW may appear only immediately inside a QUERY tag 
and may not be contained by any other container tag. 

EACHROW lias no parameters. The SQL and INTO parameters of QUERY arc identical to those in 
FETCH. QUERY docs not accept the INSIST parameter. Instead, if no rows are found, any statements 
inside an included NOROWS container tag will be executed. 

Parameters: 

SQL (expression): Required. The SQL SELECT statement that should be issued to die database. IdcnUcai 
lo FETCH. 

INTO (list of identifiers): Optional. By default, FETCH stores each returned column value in a variable 
with die same name as die column name in the query. To use different variable identifiers, specify them 
here in respective order to die columns selected in the query. For each column returned Uiat docs not have a 
corresponding identifier specified in INTO, the query-based identifier will be used as usual. Identical to 
FETCH. 

SECTIONS (number): The number of sections die query results should be broken into. The entire body of 
the QUERY tag is executed once for each of these sections. The EACHROW tag inside will run only until 
the current section is finished and then will finisli, only to run again during die ncxl section. 

WATCH Gist of identifiers): Tius is a parameter to EACHROW, not QUERY. It specifics the variables 
names tliat EACHROW should watch to determine whether they have changed since the previous row. 
When a new value is found, it will be stored in die variable "dog.new.variablename". (This paragraph needs 
improvement.) 

Examples: (The numbers 1 dirough 5 arc stored in a tabic.) 

<!QUERY SQL= ,, SELECT Num FROM Nums ORDER BY Num M > 
<UL> 

<!EACHROW> 

<LI>{num} 

<7!EACHROW> 

<yui> 

</!QUERY> 

This DOG syntax produces the following output: 

<UL> 

<J>I 

<LI>2 

<LI>3 

<LI>4 

<LI>5 
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<tul> 

<!QUERY SQL="SELECT Num FROM Nums ORDER BY Num" SECTIONS=3> 
<UL> 

<!EACHROW> 

<LI>{num} 

</!EACHROW> 

<yuL> 

<!QUERY> 

The output Uicn becomes: 

<UL> 

<LI>1 

<LI>2 

</UL> 

<UL> 

<LI>3 

<U>4 

<AJL> 

<UL> 

<LI>5 

<UL> 

<!UPDATE> 

This standalone tag performs an SQL INSERT, UPDATE, or DELETE statement. Following die tags, the 
number of rows successfully updated is stored in the dog.rowsUpdated variable. If an error occurs, the 
appropriate error variables will be set, and dog.rowsupdated will be unset — not simply set to zero. 

Parameters: 

SQL (expression): Required. The SQL DML or DDL statement to execute. Unlike FETCH and QUERY, it 
may contain unbound values represented as question marks (?). These values will be bound using the 
FROM parameter. 
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FROM (list of identifiers): Optional. Specifies the DOGtags variables whose values should be bound to Uie 
^SSSHSL 0) in the SQL query. There must be the same number of idenUfiers : l.«d « ihe FROM 
Parameter as there are question marks in the SQL parameter, or a database error will result. 

ROWS (number): Optional. Specifies the number of rows this UPDATE is expected to act on. If (he actual 
number turns out to be different from the one given here, an error will occur. 



Example: 

<!UPDATE SQL=" 



UPDATE Accounts 

SET Balance = Balance - ? 

WHERE Account_No = ? 

" FROM=amount,£rom_account> 



<!TRANSACT> 



This container tag encloses a scries of commands which function as a single transaction. U any database tag 
(FETCH, EVAL, QUERY, UPDATE) inside the TRANSACT block fails, die enure block is exited and all 
database actions performed since die beginning of the block arc undone. Because , of ^^chavior i .s 
useful to put other tags, such as EMAIL, inside the block so they will be executed only if all die database 
commands were successful. 

TRANSACT tags do not nest, either directly or indirectly. 



Parameters: 



none 



Example: 

<!TRANSACT> 

<!UPDATE SQL=" 

UPDATE Accounts 

SET Balance = Balance - ? 

WHERE Account_No = ? 

" FROM=amount,from_account> 

<!UPDATESQL=" 

UPDATE Accounts 

SET Balance = Balance + ? 

WHERE Account_No « ? 
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" FROM=amount,to_account> 
</!TRANSACT> 
<!EVAL> 



EVAL is die simplest database access tag. It is a standalone tag dial evaluates a single expression using die 
database's SQL engine and eidicr stores die result into a variable or displays it on die output. 

Parameters: 

EXPR (expression): Required. A valid SQL expression to be evaluated. This is an SQL expression, not a 
statement, and so cannot contain "SELECT," "FROM," or "WHERE," nor can it reference tables or 
columns It can, however, reference "pseudo-columns" such as User and NcxtVal in Oracle. If EXPR docs 
not evaluate to a valid SQL expression, EVAL will abort the current transaction and set die appropriate 
error variables. 

INTO (identifier): Optional. The DOGlags variable identifier into wliich die result should be stored. LfUiis 
parameter is absent, die result will be displayed on die output instead. 

Examples: 

One plus one is <!EVAL EXPR="1 + 1">. 

<!EVALEXPR="{count} + 1" INTO=count> 

<1EVAL EXPR=My_Sequence.NcxtVal INTOcurrcnt_id> 

You have been assigned an ID number of <currcnt_id} 

That pluase is <!EVAL EXPR="LENGTH({plirase:tosql})"> cliaractcrs long. 

You arc logged in to die database as <!EVAL EXPR=LOWER(Uscr)> 



Form tags 
<!FORM> 

FORM is a container tag Uiat functions similiarly to die HTML FORM tag but widi more features. 
Parameters: 

URL (expression) . . 

Optional. The absolute or relative URL to the DOGpage that should be requested when this FORM is 
submitted. 

METHOD (literal "GET", "POST", "FILE") 

Optional, defaults to "GET". The method the form should be submitted widi, either "GET", "POST", or 
•FILE" (which is like POST but allows for file upload components). 

TABLE (expression) 

Optional. Causes the field sizes of the named table in the database to be loaded into memory to serve as 
default MAXLENGTHs for any TEXTFIELD tags within this FORM. 
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SAVEDIR (expression) 

Optional defaults to "/imp/dog". Valid only for METHOD=FILE; this specifics the director)' into which 
any files uploaded via this form should be saved. It can be specified with an absolute patlmamc or a rclaUvc 
patliname to the current document. 



Examples: 



<!SEND> 

This standalone tag sends the specified variables to die next page (as hidden fields). 
Parameters: 

VARS (list of identifiers) 

Required. Specifics the DOGlags variables that should be passed along to the next page (as ludden 

fields). 
Examples: 



<!TEXTFIELD> 
Description 
Parameters: 
VAR (identifier) 

Required. The name of the DOGtags variable that this lextficld will set. Any current value held by this 
variable will be automatically filled in to the tcxtfield. 

MAXLENGTH (number) 

Optional. The maximum number of characters the user can enter into this tcxtfield. If TABLE was 
specified in this FORM'S parameter list, and the VAR parameter of this TEXTFIELD matches a column 
name in that table, and MAXLENGTH is missing or zero, it will default to that column's field width. 

SIZE (number) 

Optional. Specifies the on-screen size of the tcxtfield. If size begins with a '+■ or '-' character, it will be 
interpreted as relative to MAXLENGTH. 

NOECHO (empty) 

If present, cliaracters in this tcxtfield will appear as *'s. 

Examples: 



<!CHOICE> 

Description 

Parameters: 

TYPE (literal "PULLDOWN", "RADIO", "RADIOLINE") 
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Optional defaults to "PULLDOWN". The display style for dus CHOICE component. PULLDOWN - a 
pulldown box; RADIO = a scries of radio buttons one on top of the odicr; RADIOLINE = a sencs of radio 
buttons all on one line. 

V ^u£±Se name of the DOGtags variable that dus choice component will set Any current value 
held by Uus variable will be automatically selected in the choice component. 

T ^5£^S e 1X3010 of lhc tob,c containin e ^ valid choiccs for Ulc uscr 10 pick from in lllis choicc 

component 

V/ Qp^ to the value of VAR. The column (or column expression) in TABLE containing die 

legal values diat can be assigned to the variable VAR 

DI Opdoraf Silvio die value of VALUES. Tlic column (or column expression) in TABLE containing 
die text diat should be displayed in die on-screen choicc component for each choicc. 

WHERE (expression) . r 

Required if MORE is present. Tlic SQL "where" clause that should be used to restrict die number of 
choices offered to the uscr. If not present, all rows will be returned. 

MORE (empty) Mt . . 

If present, dien following die set of choiccs specified by the WHERE parameter will appear a choicc 
labeled "More choices...". If die user selects it, die choicc component will reload widiout applying die 
WHERE parameter. 

ORDER (expression) 

Optional. The SQL "order by" clause diat should be applied to dicsc choices. 

MANDATORY (empty) 

The presence of this parameter identifies this choicc component as one for wluch die user must maxe a 
choice. Thus if the variable lias a previous value (whether through retrieval from die database, or simply a 
default value), diere will be no "Select one" or "None" option in die choicc component; die only clickable 
items will be valid choices. 

BLANK (expression) 

Optional, defaults to "Select one" or "None" (depending on MANDATORY). This is die wording diat 
should appear on the inidal "blank" choicc. For non-mandatory choice components, diis will always appear 
at the beginning of die list of choices and defaults to "None". For mandatory choicc components, dus will 
only appear when there is no previous (or default) value for the variable, and the phrasing defaults to 
"Select one". 

Examples: 

Other Tags 

<!DOGTYPE> 

This standalone tag must be die very first object in the file. It configures the output type diat dus DOGfile 
will produce. 

Parameters: 
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Required. Tlie type of output dial diis DOGfilc produces. Tliis value is case insensitive and can currently 
be set to any of the following values: ascii, html. html3.2, htmH.O, javascript, jscript, or rtf. 

Examples: 

To begin the typical DOGpage, which produces HTML output: 

<!DOGTYPE OUTPUT=html3.2> 
To begin a DOGpage designed to generate javascript code: 

<!DOGTY~PE OUTPUT=javascript> 



<!EMAH> 

This container tag sends an e-mail message. The recipients, sender, and subject line arc configured as 
parameters to the start tag, and all the text between the start and end tags is sent as die body of the message. 

Parameters: 

TO (expression) 

Required. The rccipicnt(s) of the message. 

CC (expression) 

Optional. Any carbon-copy recipient(s) of the message. 

FROM (expression) 

Optional. The apparent sender of the message. If not specified, or if the result of evaluating die 
expression is empty, a site-configured default should be used. 

SUBJECT (expression) 

Opdonal. Subject line for die message. 

Examples: 

<!EMAIL FROM- ' { my_emai 1 } " TO=register@foo.com 

SUBJECT=*Event registration from {fullname} received M > 
Hello, 

The following registration form was submitted: 

Name: {fullname} 
Address: {street} 

{city}, {state} {zip} 
Phone #: {telephone} 

<!IFDEF my_dmail> 

You can contact tliis person at {my_email}. 

</\JFDEF> 

<V!EMAIL> 
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<!MATCH> 

This standalone tag perforins a Perl5 -compatible regular expression search on a named Text-type variable. 
Parameters: 

VAR (identifier) 

Required. The name of the DOGtags variable to check. 

REGEX (literal) . , , . , ^ * ut 

Required. A regular expression (in Perl 5 -compatible syntax) to look for m die named variable. 

INTO Gist of identifiers) 

Required. The DOGtags variables into which saved groups from the regular expression match should be 
stored. 

NOCASE (empty) . 

If present, differences in cases between the pattern and the text of the variable being searched arc 

ignored. 
Examples: 



<!INVOKE> 

This standalone tag invokes a Java method. The method you wish to invoke must accept a single parameter, 
a String array, and must return a String array as well. This is important even if your method has no real 
input or output The method and the class it is in must be public, and the method must be static/The method 
can throw any exceptions you wish; DOGtags will display the exception message in the output. 

Java Method Format: 

public static String[] myMcthod(String[] args) tlirows Exception 

Parameters: 

METHOD (literal) 

Required. The fully qualified method name, expressed as packagc.class.mcthod. For example, 
com.cpm.util.MyClass.myMethod. 

FROM Gist of identifiers) 

Optional. The variables whose values should form the String array passed into the method. If not 
present, an empty array will be passed. 

INTO Gist of identifiers) 

Optional. The variables whose values should be set from the String array returned by the method. If not 
present, the returned array is ignored. 

Examples: 

package com.cpm.util; 

import java-uuLRandom; 

public class Randomlnteger { 
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private sialic Random numGcn = new RandomO; 

public sialic String[] gcncratc(Slring[] args) Uirows Exception { 

int min = lntegcr.parselnl(args[0)); 
int max « Inleger.parsclni(args[l)); 
if(max<inin) 
llirow new Exccption("max < min"); 

int range = max - min + 1; 

int result = min + (int)(range * numGen.nextDoubleO); 

String[] tmp = {.new String(result) }; 
return imp; 

} 

And here is the DOGtags syntax to invoke tliat method: 
<!SET min=1002 max=9998> 

<!INVOKE METHOD=com.cpin.util.RandomIntcgcr.gcncratc 

FROM=min t max rNTO= r pin> 
You liave been assigned a PIN of {pin}. 



<!COMMENT> 

This container tag compiles the enclosed statements, but does not execute them. 

Parameters: 

none 

Examples: 

<ICOMMENT> Now wc make the database updates... <V!COMMENT> 



<IEXn> 

This standalone tag causes execution of the current page to terminate. It is most useful inside a condiuonal 
tag of some kind; otherwise, Hie statements following it would never be executed under any circumstances. 

Parameters: 

none 

Examples: 

<1IFNDEF name> 

Error! You must enter your name! 

<1EXTI> 
</!IFNDEF> 
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What is claimed is: 

1. A method for generating dynamic output from a system, the 
method comprising the following steps: 

a web browser providing a web browser request to a web 

5 server; 

the web server determining whether a dog file is being 
requested by the web browser request, the dog file including a 
text file having a predetermined syntax; 

if the dog file is not being requested, the web server 
10 providing to the web browser a response to the web browser 
request ; 

if the dog file is being requested, the web server providing 
a web server request to a dog server, wherein the dog server 
provides a dog file extraction request to a dog kennel to extract 
15 a compiled dog file from the dog kennel, the dog kennel providing 
a copy of the compiled dog file to the dog server, the dog server 
executing the compiled dog file and providing the dynamic output 
to the web browser. 

2. The method according to claim 1, wherein a dog file is a 

20 file that includes components that can be compiled into specific 
implementations of a requirement that an execute method that 
operates on a context and a symbol table while returning a status 
exists . 
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3. The method according to claim 1, wherein the step of the web 
server determining whether the dog file is being requested by the 
web browser includes analyzing a file extension of a file being 
requested by the web browser. 
5 4. The method according to claim 1, further comprising the 

following steps: 

the dog kennel determining whether the compiled dog file is 

in the dog kennel; and 

if the compiled dog file is not in the dog kennel, the dog 
10 kennel loading the dog file from a file system, compiling the dog. 
file, storing the compiled dog file in the kennel, and providing 
a copy of the compiled dog file to the dog server. 
5. The method according to claim 1, further comprising the 
following steps : 
15 the dog server analyzing the compiled dog file; 

the dog server establishing communication with the system; 

and 

the dog server setting up an environment for the execution 
of the compiled dog file. 
20 6. The method according to claim 1, wherein the compiled dog 
file includes a plurality of dog elements, each of the plurality 
of dog elements includes an execute method, wherein the execute 
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method returns a status object and operates on a context and a 
symbol table to produce the dynamic output. 

7. The method according to claim 1, wherein the execution of 
the compiled dog file includes providing a dynamic output 

5 response to a communication manager of the dog server, wherein 
the communication manager manages the dynamic output response 
provided as a result of the compiled dog file. 

8. The method according to claim 1, wherein the dynamic output 
is provided to the web browser through a portal provided by the 

10 web server. 

9. An apparatus for generating dynamic output from a system, 
the apparatus comprising: 

a web browser ; 

a web server coupled to a web browser; 

15 a dog server coupled to a web server; and 

a dog kennel coupled to a dog server, wherein the web 
browser provides a web browser request to the web server, the web 
server determines whether a dog file is being requested by the 
web browser request, if the dog file is not being requested, the 

20 web server provides to the web browser a response to the web 
browser request; if the dog file is being requested, the web 
server provides a web server request to the dog server based on 
the web browser request, the dog server provides a dog file 
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extraction request to the dog kennel, the dog kennel provides a 
copy of a compiled dog file to the dog server, and the dog server 
executes the copy of the compiled dog file and provides the 
dynamic output to the web browser. 
5 10. The apparatus according to claim 9, wherein the dynamic 
output is provided to the web browser through a portal provided 
by the web server. 

11. The apparatus according to claim 9, wherein the dog server 
includes a communication manager. 
10 12. The apparatus according to claim 9, wherein the execution of 
the compiled dog file includes providing an output response on 
manager of the dog server, wherein the communication manager 
manages the dynamic output response provided as a result of the 
compiled dog file. 
15 13. A method for creating a dog tag which is associated with a 
class and a type, the method comprising the following steps: 

providing a unique tag name for the dog tag; 

determining the type of the dog tag; 

assigning the dog tag to a package; 
20 extending the class for the type of the dog tag; 

implementing an execute method for the dog tag; 

importing a library; 

providing a constructor; and 
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creating a file implementing the steps of providing a unique 
tag name, determining the type of the dog tag, assigning the dog 
tag to the package, extending the class of the type of the dog 
tag, implementing the execute method, importing a library, and 
5 providing the constructor. 

14. The method according to claim 13, further comprising the 
step of providing at least one parameter and the respective 
parameter type for the dog tag. 

15. The method according to claim 13, wherein the file created 

10 is a JAVA file. 

16. The method according to claim 13, further comprising the 

following steps : 

compiling the file; and 
restarting a dog server. 

15 17. The method according to claim 13, further comprising the 
following step: 

importing an input/output handling package. 

18. The method according to claim 13, wherein the library 
includes objects necessary to implement basic functionality of 

20 the dog tags. 

19. The method according to claim 13, wherein the step of 
assigning the dog tag to a package includes assigning the dog tag 
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to at least one of an existing tag package and a new package 
which is added to a list of potential tag packages. 
20. A method for establishing an interface with an external 
system, the method comprising the following steps: 
5 a web browser providing a web browser request to a web 

server; 

the web server determining whether a dog file is being 
requested by the web browser request; 

if the dog file is not being requested, the web server 
10 providing to the web browser a response to the web browser 
request ; 

if the dog file is being requested, the web server providing 
a web server request to a dog server based on the web browser 
request, wherein the dog server provides a dog file extraction 
15 request to a dog kennel for the dog file requested by the web 
browser, the dog kennel providing a copy of a compiled dog file 
to the dog server, and the dog server executing the compiled dog 
file, wherein the execution of the compiled dog file establishes 
an interface with the external system. 
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